home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / maximus / max2tbbs.zip / TUIMP.DOC < prev    next >
Text File  |  1994-08-08  |  6KB  |  166 lines
  1.  
  2.                         TBBS Userlog Importer
  3.  
  4.                          by Paul Blitz
  5.  
  6.  
  7.                            Version 1.00
  8.                              13/04/94
  9.  
  10.  
  11. Introduction
  12. ============
  13.  
  14. I am about to change from using another BBS system to TBBS, version 2.2,
  15. and want to be able to import the userlog details from the old BBS.
  16.  
  17. I decided to make this a 2-part process: One program will EXPORT the details
  18. from the other BBS to a "standard" format, comma delimited. By "standard" I
  19. mean a suitable common format that I have selected, so that exporting
  20. programs can be written for many other BBSES.
  21.  
  22. In case I decide to "tweak" the comma-delimited file format in any way, the
  23. first line of the import file contains a "version number": if this format is
  24. not compatible, then TUIMP will flag it up as an error. This might save a
  25. lot of future heartache, sorting out problems!!
  26.  
  27. This program is written specifically for importing a userbase into a NEW
  28. TBBS setup: with this in mind, my belt-and-braces approach does the
  29. following:
  30.  
  31. 1) TUIMP will rename your old USERLOG.BBS to ULOGBBS.BAK, and your USERLOG.PTR
  32. to ULOGPTR.BAK, just in case you need to recover them. (However, taking a
  33. back-up copy before running TUIMP is something that any sensible TBBS sysop
  34. would do!)
  35.  
  36. 2) Only the sysop record is retained from the existing TBBS USERLOG.BBS
  37. file.
  38.  
  39. 3) The sysop's pointer to the USERLOG.PTR file is zeroised.
  40.  
  41. 4) The USERLOG.PTR file is itself "zeroised" (ie to be exactly like the
  42. distribution copy): if it doesn't exist, it will be created.
  43.  
  44. 5) The USERLOG.INX file is deleted.... TBBS will recreate this file when you
  45. run TBBS again.
  46.  
  47.  
  48. Where specific data is not imported, either the Sysop's USERLOG.BBS setting
  49. will be used as defaults, or the items are "zeroed": the details of these
  50. are given later. It is probably that you will want to apply a template
  51. globally after running TUIMP, so if the settings are wrong, you should be
  52. able to "recover" without any problems.
  53.  
  54. If you run this on a COPY of your TBBS USERLOG.BBS (which is a sensible
  55. idea), then make sure that when you go live with these NEW versions, that
  56. you delete the old "working" copies of *ALL* of USERLOG.BBS, USERLOG.PTR and
  57. USERLOG.INX before you copy over the newly created files. If you do not do
  58. this, then there is no doubt that TBBS will screw up, due to the confusion!
  59.  
  60. A separate file details the format of the input file: this can be created
  61. either manually (rather you than me), from a database, or by a suitable
  62. "exporting" program, from your existing BBS userbase file.
  63.  
  64.  
  65. *REMEMBER*: TUIMP is designed for NEW TBBS systems, and will completely
  66. erase any users you may have in your current userlog, and will obliterate
  67. all details in the .PTR file.... this program is NOT suitable for ADDING new
  68. users to an existing TBBS setup.
  69.  
  70.  
  71.  
  72. Running the program
  73. ===================
  74.  
  75. The program calling syntax is:
  76.  
  77.     TUIMP <input file>
  78.  
  79. .... if you don't give an input filename, it will use a default filename of
  80. "USERLOG.TXT.
  81.  
  82. TUIMP will look for your USERLOG.BBS in the current directory ONLY: if TUIMS
  83. can't find it there, it will simply exit with an error.
  84.  
  85. The backup files, together with the new USERLOG.BBS and USERLOG.PTR files
  86. will be created in the current directory.
  87.  
  88.  
  89. The returned error levels are:
  90.  
  91.     0 : Program ran OK
  92.     1 : Error in command line parameters
  93.     2 : Control-C / Escape was pressed during program
  94.     99: Internal procesing error (eg: out of range value)
  95.  
  96. All errors will also return an error message on the screen, with as
  97. much useful information as possible.
  98.  
  99.  
  100. Copyright Etc:
  101. ==============
  102.  
  103. Hobby Use:
  104. ----------
  105.  
  106. Lets put it simply: I wrote this program, so if anyone makes any money
  107. from it, its going to be me! I therefore hold the copyright on this
  108. work of art (!).
  109.  
  110.  
  111. If you actually ENJOYED the program, or found it really useful, then I
  112. ask you to send me either a small donation (cash - UK pounds and US dollars
  113. - is acceptable), or something else in lieu (if you are THAT skint, send me
  114. a picture postcard or two, and tell me how much you love the program <grin>)
  115.  
  116.  
  117.  
  118. Comercial Use:
  119. --------------
  120.  
  121. If you want to use the program in any way that is even remotely
  122. commercial (*), then you may do so ONLY with my permission ...... just
  123. contact me: I AM friendly, and I don't cost THAT much!!!
  124.  
  125. (*) I'll define "commercial" as a "system run with the intention of making
  126. profit for the sysop, or run a for a commercial organisation". So if you do
  127. charge users to use your BBS, but ONLY with the INTENTION of it being
  128. sufficient to cover the costs, then I'll take the lenient view that you are
  129. running a NON-commercial system. A "Support BBS" for a "for profit" business
  130. / organisation is deemed to be commnercial.
  131.  
  132. If in doubt, common sense (mine!) will prevail!
  133.  
  134.  
  135.  
  136. How to find me:
  137. ===============
  138.  
  139. Paul Blitz,
  140. 25, Woodgreen Road,
  141. Harestock,
  142. Winchester,
  143. Hants,
  144. SO22 6LZ.
  145.  
  146. Feel free to write to me, or contact me by phone at home (between
  147. 20:00 and 22:00 (UK time) ONLY please) on +44 962-885696.
  148.  
  149. You may call my BBS: "The Cardboard Box BBS" on +44 962-880278 (for those of
  150. you in the UK, who don't understand international dialling, call 0962
  151. 880278).
  152.  
  153. You can send email to me at Fidonet 2:252/201, or Chatnet 44:2520/201.
  154.  
  155.  
  156. Revision History
  157. ================
  158.  
  159.   1.01- 08/08/94  :   2 sillies:
  160.                       (1) user name must be forced to caps
  161.                       (2) password should be null-padded, not space-padded
  162.  
  163.   1.0 - 13/04/94  :   Initial version.
  164.  
  165.  
  166.